home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / wildcat / digfos11.zip / DF.DOC next >
Text File  |  1993-01-11  |  12KB  |  331 lines
  1.  
  2.                            DIGIFOSSIL V1.1 - Jan 11, 1992
  3.  
  4.                           Fossil Interpreter for DigiBoards
  5.                           =================================
  6.  
  7.                                                Technique Computer Systems
  8.                                                Ste 110, 1841 Oak Bay Ave
  9.                                                Victoria, BC   V8R 1C4
  10.                                                CANADA
  11.                                                BBS: (604) 598-1546
  12.                                                FAX: (604) 598-4318
  13.  
  14.  
  15.           What is it?
  16.           -----------
  17.           DIGIFOSSIL (DF) is  the program YOU  need in order  to get a huge
  18.           number of  doors, written for  FOSSIL systems,  working with your
  19.           Wildcat! IM system.  (if you need a FOSSIL for a non-IM/Digiboard
  20.           system,  try either  X00 or  BNU, which  are available  from many
  21.           BBSs)
  22.  
  23.  
  24.           What is a FOSSIL anyway?
  25.           ------------------------
  26.           FOSSIL  (Fido/Opus/Seadog  Standard Interface  layer) was created
  27.           to  provide  a  standard   communications  interface  during  the
  28.           evolution of some other BBS  software (namely Fido(tm),  Opus and
  29.           Seadog(tm)).  It  provided a  superset of  the serial  port calls
  30.           available  on  the early  IBM  PC,  and provided  a  way  to port
  31.           programs from  one system  to another,  that may  no use hardware
  32.           compatible serial ports to the IBM PC.
  33.  
  34.           By writing programs that use a standard set of calls, all that is
  35.           required  to move  the system  to dissimilar  hardware, is  a new
  36.           Fossil driver.
  37.  
  38.  
  39.           What does DIGIFOSSIL do?
  40.           ------------------------
  41.           It provides the translation services so that calls made to FOSSIL
  42.           standards are  translated into equivalent  Digiboard calls.  This
  43.           allows HUNDREDS of  applications written for  FOSSIL to run under
  44.           IM, as if they were running  on a FOSSIL based system.  This list
  45.           includes many  popular doors such  as Tradewars  & Scrabble (tm).
  46.           Think  of  it as  the  'missing  link' between  your  Wildcat! IM
  47.           system, and vast number of existing doors.
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.                                         - 1 -
  59.  
  60.               DigiFossil (c) Copyright 1992, Technique Computer Systems
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.           Installation
  69.           ------------
  70.           Simple,  part of  your AUTOEXEC.BAT,  before Desqview  is loaded,
  71.           should load the TSR driver for DF.  Simply add:
  72.  
  73.                        DFTSR
  74.  
  75.           to  your  AUTOEXEC.BAT.   When  DFTSR  starts,  it  will identify
  76.           itself,  and indicate  the  type of  Digiboard  installed.  DFTSR
  77.           currently  takes about  14k  of memory,  and  can be  loaded into
  78.           'HIGHRAM' using QEMM's LOADHI, or DOS 5's LOADHIGH commands.
  79.           It must be loaded AFTER the DigiBoard (XIDOS5) driver is loaded.
  80.  
  81.  
  82.           Using Doors that work with FOSSIL Drivers
  83.           -----------------------------------------
  84.           Although  DIGIFOSSIL may  not run  all doors,  it will  run those
  85.           doors that  require or  support FOSSILs.   If a  program does not
  86.           mention that  it will utilize  a FOSSIL, it  probably doesn't use
  87.           it, and work with DIGIFOSSIL.
  88.  
  89.           When running a door that  requires FOSSIL support, simply use the
  90.           program DF to enable or  disable FOSSIL support in the DIGIFOSSIL
  91.           driver (DFTSR which was loaded in your AUTOEXEC.BAT).  To run DF,
  92.           simply specify which Digiboard channel,  and whether to enable or
  93.           disable support.   If no  port number is  given, DF  will use the
  94.           port specified by the environment variable WCPORTID.
  95.  
  96.           ** NOTE **
  97.           **    Be sure that if you enable FOSSIL support, that you
  98.           **    disable it again before re-loading Wildcat!.
  99.           **    (I suggest that you add DF OFF to your CAT.BAT)
  100.  
  101.  
  102.           examples:   DF ON 1     - turn on FOSSIL support for port 1
  103.                       DF OFF      - turn off support for port WCPORTID
  104.                       DF LOCK 1   - turn on FOSSIL support for port 1
  105.                                      but don't allow the door to change
  106.                                      the baud rate.
  107.  
  108.           When  using doors  that support  FOSSIL,  such as  Scrabble, COM1
  109.           (w/FOSSIL), is the same as Digiboard  channel 1.  That is to say,
  110.           if  you set  WCPORTID  to 1,  your should  tell  the DOOR  to use
  111.           (FOSSIL) COM1.
  112.  
  113.           If you have a door that does  NOT support a locked DTE rate (that
  114.           is when the baud rate to the modem is higher than the actual link
  115.           connection speed), AND  you are using  a modem that  has a locked
  116.           DTE, you should can use the DF LOCK command rather than the DF ON
  117.           command, which will prevent the  DOOR from changing the baud rate
  118.           on the modem.
  119.  
  120.  
  121.  
  122.  
  123.  
  124.                                         - 2 -
  125.  
  126.               DigiFossil (c) Copyright 1992, Technique Computer Systems
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.           NOTE!
  135.               Programmers  writing code  that makes  FOSSIL calls
  136.               should  note  COM1, and  WCPORTID=1  both  refer to
  137.               channel 0 (DX=0) in the  actual with respect to the
  138.               actual FOSSIL and DigiBoard drivers.
  139.  
  140.           Examples
  141.           --------
  142.           This is an  example DOOR.BAT for  Chris Hall's excellent Scrabble
  143.           door.
  144.  
  145.           DOOR1.BAT
  146.              @ECHO OFF
  147.              REM This batch file is located in your HOME directory,
  148.              REM and is copied to the work directory and executed.
  149.              REM It needs to change to the right location of the
  150.              REM door and run the program
  151.              REM
  152.              REM  ******* Enable Fossil
  153.              DF ON
  154.              CD \DOORS\scrab
  155.              scrabdor node%WCNODEID%.cfg
  156.              CD \WC30
  157.              REM  ******* Remember to turn it off again
  158.              DF OFF
  159.              REM The above example takes its parameters from a
  160.              REM configuration file located in the door directory.
  161.              REM Others may take command line arguments for information
  162.              REM such as CHESS.EXE %WCPORTID% where the %WCPORTID% gets
  163.              REM replaced by the com port number by DOS when
  164.              REM the program is run.
  165.  
  166.           Files
  167.           -----
  168.           The following files should be included in this archive, and for
  169.           authenticity,   it   should   contain   the   PKZIP  authenticity
  170.           verification for TECHNIQUE COMPUTER SYSTEMS.
  171.  
  172.               DF.EXE         - to enable and disable DIGIFOSSIL support
  173.               DFTSR.EXE      - the DIGIFOSSIL driver
  174.               DF.DOC         - this document file
  175.               ORDERFRM.DOC   - Ordering information
  176.  
  177.  
  178.           Registration & Ordering
  179.           -----------------------
  180.           DIGIFOSSIL is  NOT free.  Although  it is distributed  in a fully
  181.           functional   form,  continued   use   beyond  30   days  requires
  182.           registration.   Registered  versions   are  always  available  to
  183.           registered users on the PLYWOOD PC BBS at 604-598-1546.
  184.           Registration costs $15 (US), or $18 (Canadian).  To order, please
  185.           use the order form found in this archive.  You can also order the
  186.           product  online on  the Plywood  PC BBS  at 604-598-1546,  or FAX
  187.           completed order forms to 604-598-4318.
  188.  
  189.  
  190.                                         - 3 -
  191.  
  192.               DigiFossil (c) Copyright 1992, Technique Computer Systems
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200.           Support
  201.           -------
  202.           For further information, or technical support of DIGIFOSSIL, your
  203.           best bet is to call the call the Plywood PC BBS at 604-598-1546
  204.           (V32bis/HST), and join conference 2 (DIGIFOSSIL support).
  205.           Other options are: leave email to SCOTT BRYNEN in the 3rd party
  206.           support conference on MSI's Bulletin Board (805-395-0650), or the
  207.           MSI-OffTopic conference, that is echoed to many email networks.
  208.           Another option is to FAX us at 604-598-4318.
  209.  
  210.           Some FOSSIL applications may not work.  If you have problems with
  211.           a specific application  (or have found one  that works well), let
  212.           us know, so  that in future  versions we can  list doors that are
  213.           known to work.
  214.  
  215.           If  you  have  a  node  that  crashes  during  operation  of  the
  216.           DIGIFOSSIL, please make  a note of the  conditions under which it
  217.           happened,  and  if  you  are able,  open  another  DOS  window in
  218.           Desqview, and type
  219.                 DF STAT <port-number>
  220.           where  <port-number>   is  the   port  that   has  failed.   This
  221.           information that this provides will  be most helpful in trying to
  222.           diagnose what has happened.
  223.  
  224.  
  225.           Updates
  226.           -------
  227.           By  registering the  product  with Technique  Computer,  you will
  228.           receive the most recent version by mail (please allow 6-8 weeks),
  229.           and be able  to download the  latest version of  it from our BBS.
  230.           Once  you are  registered, you  can  download future  versions of
  231.           DIGIFOSSIL from the Plywood PC BBS.
  232.  
  233.  
  234.           Credits
  235.           -------
  236.           I have a few people to thank.  Firstly, I would like to thank Ron
  237.           Green, and Ken O'Connor for their patience, and for letting me at
  238.           their Wildcat!  IM baby in  order to get  DIGIFOSSIL working, and
  239.           also to Ron Green for saying "but we can't run Scrabble now we've
  240.           gone to Wildcat! IM",  and to Chip North (and his co-sysop), for
  241.           actually  proving that it works with more than Scrabble.
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.                                         - 4 -
  257.  
  258.               DigiFossil (c) Copyright 1992, Technique Computer Systems
  259.  
  260.  
  261.  
  262.  
  263.  
  264.  
  265.  
  266.           History
  267.           -------
  268.           Version 1.1 - Jan 11/1993
  269.                    - Added support for forcing Locked DTEs.
  270.                    - Added beg screen to unregistered version.
  271.                       (lack of registrations caused this)
  272.                    - Fixed minor typos in the orderform.
  273.                    - Added better support for detecting errors during
  274.                       installation.
  275.  
  276.           Version 1.0 - Dec 25/1992
  277.                    - Initial Release
  278.  
  279.  
  280.           Legal Stuff
  281.           -----------
  282.           DIGIFOSSIL  is Copyright  1992-1993, Technique  Computer Systems,
  283.           all rights  reserved.  This  product is  provided "AS-IS" without
  284.           warranty of any kind.  All risk as to the results and performance
  285.           are  assumed  by you.   Technique  Computer Systems  will  not be
  286.           liable for  any damages, direct  or indirect,  resulting from the
  287.           use, or inability to use, this product.
  288.  
  289.           Wildcat! isn't actually a trademark of Mustang Software Inc (but
  290.                         is a very good BBS package)
  291.           DigiBoard could be a trademark of DigiBoard
  292.           Fossil (Fido(tm)/Opus/Seadog(tm) interface layer), is the
  293.                         combined product and ideas of Tom Jennings, Thom
  294.                         Henderson, Vince Perriello, & Wynn Wagner (& many
  295.                         more).
  296.           Fido is a trade mark of Tom Jennings
  297.           Seadog is a trade mark of Thom Henderson and/or System
  298.                         Enhancements Associates.
  299.           QEMM and Desqview are trade marks of Quarterdeck Office Systems.
  300.  
  301.  
  302.  
  303.  
  304.  
  305.  
  306.  
  307.  
  308.  
  309.  
  310.  
  311.  
  312.  
  313.  
  314.  
  315.  
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.                                         - 5 -
  323.  
  324.               DigiFossil (c) Copyright 1992, Technique Computer Systems
  325.  
  326.  
  327.  
  328.  
  329.  
  330.  
  331.